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Special Notices 


References in this publication to IBM products, programs, or services do not imply 
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About This Book 


C 


This book describes the online documentation provided with the Virtual 
Machine/Extended Architecture System Product Release 2.1 (VM/XA SP2.1) 
product. This documentation is of two types: 


¢ Base documentation that is provided with the product when it is shipped 
e Program update information that becomes available from time to time during 


the life of the product. 


The online feature of VM/XA SP2.1 contains both the nonlicensed books from the 
base library and any program update information manuals that are available. 


Note: During the life of this product, new program update information may become 
available. Periodic updates to the feature tapes will be made containing the 
added information. 


( Throughout this book, online means information made available in machine-readable 
form that can be searched and viewed at a display terminal. For the definitions of 
the terms used in this guide see “Terms Used in This Book.” 


The SP2.1 online library is available in two forms: 


e Source files containing text and art that can be formatted for either printing or 
display 


¢ BOOK files formatted to be displayed using the BookManager Read program 


( % product. 


This booklet covers both forms. It is not designed to make you an expert in using 
online information, or in using the other products that are associated with using 
online information. Instead, this book should serve as a quick guide to more 
detailed sources of information. A bibliography at the end of this book provides a 
list of the manuals associated with each of the products that may be used with online 
documentation. 


Note: This manual is available in two forms: as a printed book, and as one of the 
- online books on tape. Because of this, the online version of the book may 
( contain additional information that could not be included in the printed 
version, and should be considered the more current one. 


Who Should Use This Manual 


This manual is intended to be used by those people who are responsible for receiving 
and installing the online information from IBM. 


Terms Used in This Book 


A number of IBM products are mentioned in this guide. In addition, there may be 
some unfamiliar terms used. These products and terms are defined below. 


Term Definition 


ADMGDF A file used by GDDM to store a graphics picture in 
GDDM’s graphics data format (GDF). 
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ADMIMG 


BookManager 


BookManager BUILD 


BookManager READ 


BookMaster 


control word 


DrawMaster 


DCF 


GDDM 


GML 


GRAFFILE 


Online 


ProcessMaster 


PSEG 


SCRIPT 


tag 


VM/XA SP2.1 Online Documentation 


A file used by GDDM to store an image aon in 
GDDM’s standard image format. 


A family of program products (Beekiiaiader BUILD 
and BookManager READ) that lets you create and 
display online books. 


A program product that creates online books from 
SCRIPT source files. 


A program product that allows you to search, read, and 
annotate online books. 


A generalized markup language that is more extensive 
than the GML Starter Set. 


In SCRIPT, an instruction that causes a certain format- 
ting result. 


A program product that creates and edits graphics data. 


Document Composition Facility. An IBM licensed a > 
program for formatting documents for printing. It works ae 
with BookMaster. 


Graphical Data Display Manager. An IBM licensed 
program for displaying graphical information on termi- 
nals. 


Generalized Markup Language (GML). A language used 
to identify the elements of a source document without 


respect to specific formatting. e Ke 


A file created by a graphics editor like DrawMaster that — y 
contains the information needed to display one picture. 


Available interactively at a computer display device. 


An IBM licensed program that allows easy access to a 
wide variety of other IBM programs, such as BookMaster 
and DCF. 


An object containing composed text and images, prepared 
before formatting and included in a document by Pome 
SCRIPT. a, 


A file type used by DCF to contain textual information 
including GML and BookMaster tags. 


In GML markup, a name for a type of document or docu- 
ment element. For example, :p might be the tag used to 
identify a paragraph. 
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VM/XA SP Books Shipped 


Table | and Table 2 on page 2 list the manuals shipped as part of the online fea- 
tures that are from the Virtual Machine/Extended Architecture* System Product 
(VM/XA* SP) Release 2.1 library. These tables show the form number for each 
manual, the master file name, and the tape file number. Table 2 on page 2 lists the 
program update information manuals, that update one or more books in the base 
library. 


How the names are formed that are under “Master File Name” is explained in more 
detail in “How Books Are Organized” on page 4. 


Note: In the following table, titles marked with an asterisk contain minor editorial 
changes 


Table 1 (Page 1 of 2). VM/XA SP2.1 Base Library Books Shipped on Tape 


Master File 
Book Form Number Name 


Using Online Documentation* GC23-0522 LABZMST 


Application Development Guide for FORTRAN and SC23-0369 
COBOL* 


6 
7 


Tape File 


CP Programming Services SC23-0370 10 
GC23-0434 7 


Directory of Programming Interfaces for Customers 


Dump Viewing Facility Operation Guide and Refer- 


SC23-0433 LAABMST {2 
ence 


EXEC 2 Reference §C23-0361 


| Library Guide, Glossary, and Master Index GC23-0367 LAAGMST 17 
GC23-0378 LAAHMST 18 
LAAKMST 19 


SC23-0371 
System Messages and Codes Reference SC23-0376 LAALMST 
LAANMST 


System Product Editor Command and Macro Refer- | SC23-0372 
~ ence 


Planning and Administration* 


Real System Operation 


fil 
paar 
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Table 1 (Page 2 of 2). VM/XA SP2.1 Base Library Books Shipped on Tape 


2 
25 
26 


Virtual Machine Operation ~| S$C23-0377 LAAMMST 
21 


| | Guide to Saved Segments SC23-0457 
| | CMS Primer SC23-0368 LABYMST 
| Release Guide GC23-0510 LABOMST 28 


Table 2. Program Update Information Manuals Shipped on Tape 


Master File 
Book Form Number Name Tape File 


| Serviceability Enhancements APAR VM37518 GC23-0503 LABCMST 


Table 3 lists the books not included in the online VM/XA SP2.1 library. 


Table 3. VM/XA SP2 Books not Shipped as Online Information 
Form Number 


CMS Data Areas and Control Blocks LY27-8051 


CP Diagnosis Reference LY 27-8054 
Diagnosis Guide | 


GCS Diagnosis Reference LY27-8060 . 


Licensed Program Specifications GC23-0366 


Quick Reference 3 SX23-0391 
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Differences Between Online Books and Printed Manuals 
Because of the differences between printed and online books, certain features of the 
printed manuals are not present in the online versions. These differences are summa- 
rized below: 


¢ Library Guide, Glossary, and Master Index is printed in 2-column format, but is 
displayed online in one column. The foldout page at the end of the printed 
book is not reproduced in the online version. 


e System Messages and Codes is printed in 2-column format, but is displayed in 
l-column format. 


¢ CP Programming Services appendixes A, B, and C must be printed using a line- 
| printer, for example a 3800 model 1. These appendixes cannot be displayed 
using BookManager™. 


| e The reference card at the back of the CMS Primer is not included in the online 
information. 


( What is On the Distribution Tapes 


Online documentation for VM/XA SP2.1 is available in two forms: 
e Source files 
¢ BookManager displayable files. 


Both features are available on tape. Displayable files are shipped to all customers. 
For information on ordering the source feature, see your IBM marketing represen- 


( = tative. 


Each tape contains all of the books listed in Table | on page 1, but in different 
formats. The source tape contains SCRIPT files, which contain text, GRAFFILEs 
(the online art files created by DrawMaster*), PSEG3820 files (the printable versions 
of the GRAFFILEs), and ADMGDF files (the displayable versions of the 
GRAFFILEs). 


The BookManager tape contains files with the filetype of BOOK. These are the dis- 
playable versions of the manuals. 


( | Both tapes are created with the VMFPLC2 command. 


Tape Arrangement 


Each feature tape is arranged in the following order: 


| ¢ Tape file 1—The Memo to Users, which includes the files for Using Online Doc- 
| umentation, and a list of all the files contained on the tapes, VMXASP21 | 
| PARTLIST. 


¢ Tape files 2 to 29—Book files. Each tape file contains all the files for a partic- 
ular book. See Table 1 on page 1 and Table 2 on page 2 for their order. 
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How Books Are Organized 


Removing the Files from the Tape 


The files may be removed from the tapes with the CMS VMFPLC2 LOAD 
command. To load a specific book you should position the tape at the correct tape 
file and use VMFPLC2 LOAD * * n, where n is the filemode of the disk where the 
files are to be loaded. 


Space Requirements 


Each source version of a book is made up of a different number of files. The dis- 
playable version of any book has only one file associated with it. The source 
SCRIPT and art files require approximately 200 cylinders of 3380 disk storage, in 
4kb blocks, or the equivalent. The BOOK files require approximately 100 cylinders 
of 3380 disk storage. 


For information on the names of the files that make up each book see the 
VMXASP21 PARTLIST file, which is in the first tape file on the feature tapes. 


Each book has a similar physical layout. A book is made up of one master file, for 
example LAAIMST. Within this file are the BookMaster* macro tags for imbed- 
ding all of the other files that make up the book, such as LAAIPRE and 
LAAIGLO. Most books have only one level of imbedding, but some may have 
additional levels. 


Naming Conventions js 


All of the books in the library follow a naming convention. All of the files associ- ae, 
ated with a particular book begin with the same 4-character code. The next four 

positions of the filename are used to identify the particular file. For example, all the 

files associated with CMS User's Guide begin with the characters LAAS. The master 

file for CMS User's Guide is LAASMST. 


-~ 
\ H 


4 VM/XA SP2.1 Online Documentation 


Common Filenames 


Filetypes 


The last four characters in the names of certain types of files are common 
throughout the SP2.1 library. Table 4 lists these files and describes their function. 


Table 4. Common VM/XA SP2 Filenames 


xxxxLIB2 The second half of the VM/XA SP2.1 library 
diagram 


Not all books contain all of these pieces of information, but those that do will follow 
this naming convention. 


The filetype for online files may be one of several kinds, based on the contents of the 
file. The filetypes are important because the various programs expect certain 
filetypes. For instance, BookManager expects the filetype BOOK for displayable 
files. Table 5 describes the various filetypes and their contents. 


Table 5. Soft Copy Filetypes 


SCRIPT Text source files, containing SCRIPT control words 
and BookMaster tags 


GRAFFILE DrawMaster art source files 


PSEG3820 The printable version of a GRAFFILE 


ADMGDF The BookManager viewable version of a 
GRAFFILE 


ADMIMG The displayable version of a scanned image 
The BookManager viewable file | 
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C Using Online Information 
Online information may be used in a number of ways. For instance, you may want 
to use portions of several books in the VM/XA SP2.1 library to produce a “run- 
book” of essential information for computer operators. You may also wish to add 
new information to match your own facilities. Copies of these books may be printed 
as the need arises. Finally, using the BookManager product, BOOK files may be 
displayed on terminals, allowing quick access to the information in the entire library. 


How to Tailor Books 


The information on the source feature tape may be tailored to meet your specific 
needs. Once you have changed the SCRIPT files, you may either reprint the manual 
using BookMaster, or rebuild a displayable version using BookManager. The 
_ GRAFFILE may be edited using DrawMaster, and new PSEG3820 or ADMGDF 
( files may be created from it. The different filetypes require different editors. The 
— table below lists the editors needed for each filetype. 


Table 6. Source File Editors 


SCRIPT Any text editor such as XEDIT or ISPF/PDF to add the 
SCRIPT and BookMaster tags. (See note.) 
GRAFFILE 
be converted to a PSEG38xx or ADMGDF file using 
DrawMaster. 


BOOK Cannot be edited | 
ADMGDF Cannot be edited 
ADMIMG Cannot be edited 


Note: SP2.1 books contain two forms of art: DrawMaster-generated GRAFFILEs, 


DrawMaster or another graphics editor. The new file may 


_— and character graphics. Character graphics are contained within the SCRIPT 
( files, but they cannot be edited using normal text editors. In order to display 
aa and edit these pieces of art successfully you will have to use the 


ProcessMaster* character graphics editor. See BM Publishing Systems 
ProcessMaster Character Graphics Editing, SC34-5036, for more information. 
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How to Print Books 


The way you print manuals from the source SCRIPT files depends on the way your 
individual site has configured your system. In general, the command to format and 
print a book from SCRIPT files is: 


SCRIPT file-id (options ... 


The options that you use will depend upon what sort of printer the output is directed 
to. Remember that the VM/XA SP2.1 books have been written with BookMaster 
tags. This means that BookMaster must be installed for the books to format cor- 
rectly. Although BookMaster can produce output for a number of different devices, 
the SP2.1 library has been created for printing on an all points addressable device, 
such as a 3820 page printer. Art created with page segments cannot be printed on 
non-all points addressable printers, such as the 3800 mod 1. Different page sizes for 
different printers may also determine how the books look. You should consult the 
BookMaster manual to determine which printers BookMaster supports. 


How to Display Books 


The BOOK files from the BookManager feature tape may be viewed using the 
BookManager READ licensed program. To begin using BookManager READ you 
should issue the following command: 


BOOKMGR 


BookManager READ is meant to allow you to use online books in the same way 
that you have always used printed information. For more information on using 
BookManager READ see “BookManager READ” on page 10. Although 
BookManager READ can be used on any terminal that is supported by GDDM", 
different terminals have different display characteristics. You may not achieve iden- 
tical results when viewing books on different devices. 


How To Build Books 


If you are going to use BookManager BUILD to prepare displayable files for 
viewing, you must have access to the SCRIPT source files. You must have DCF for 
books using SCRIPT control words and starter set GML tags. If you are going to 
build IBM-supplied books, you will also need the BookMaster program product. 


The basic command to build a book is: 
BUILD file-id (options... 


For more information on building books see “BookManager BUILD” on page 10. 
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Cc Product Information 


The following lists of books will help you better understand the various products 
that can be used with online information. These manuals should be consulted for all 
technical questions regarding the individual products. These lists are not meant to 
be exhaustive. In all cases, the bibliographies provided with each product should be 
consulted for additional information. 


Document Composition Facility 


¢ IBM Document Composition Facility: SCRIPT/VS Language Reference, 
SC34-5008 


¢ IBM SCRIPT Mathematical Formula Formatter User's Guide, SH20-6453 
. ¢ Text Programmer's Guide, SH35-0069 
( ¢ General Information, GH20-9158 
¢ Generalized Markup Language Starter Set User’s Guide, SH20-9186 
¢ GML Starter Set Reference, SH20-9187 
¢ GML Starter Set Implementation Guide, SH35-0050 
¢ GML Concepts and Design Guide, SH20-9165 
¢ DCF Diagnosis Guide, SY35-0067 
( ~ ¢ DCF Messages, SH35-0048. 


BookMaster 
¢ IBM Publishing Systems Book Master General Information, GC34-5006 
¢ IBM Publishing Systems Book Master User’s Guide, SC34-5009 
¢ IBM Publishing Systems Book Master Creating Named Styles, SC34-5008. 


( ProcessMaster 
¢ IBM Publishing Systems ProcessMaster General Information, GC34-5031 
¢ IBM Publishing Systems ProcessMaster Editing, SC34-5035 
¢ IBM Publishing Systems ProcessMaster Character Graphics Editing, SC34-5036 
¢ IBM Publishing Systems ProcessMaster User's Guide, SC34-5033. | 
DrawMaster 


¢ IBM Publishing Systems DrawMaster General Information, GC34-5021 
¢ IBM Publishing Systems DrawMaster Introduction, SC35-5023 
e IBM Publishing Systems DrawMaster User's Guide and Reference, SC34-5022. 
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BookManager 
¢ BookManager General Information, GC23-0447. 


BookManager BUILD 


¢ Installation and Customization, SC23-0451 
¢ Preparing Online Books, SC23-0450. 


BookManager READ 7 
°¢ Getting Started and Command Summary, SC23-0448 


¢ Displaying Online Books, SC23-0449 
¢ Installation and Customization, SC23-0455. 


Additional Information 
¢ GDDM, Version 2, Release 1 Base Programming Reference, SC33-0332 
¢ GDDM, Version 2, Release 1 Guide for Users, SC33-0327 
¢ APL2 Programming: System Services Reference, SH20-9218 
© APL2 GRAPHPAK: User's Guide and Reference, SH20-9230. 
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Virtual Machine/Extended Architecture Reader’s 
System Product Comment Form 
Release 2.1 


Using Online Documentation 
Order Number: GC23-0522-1 


This manual is part of a library that serves as a reference source for systems analysts, programmers, and operators of 
IBM systems. You may use this form to communicate your comments about this publication, its organization, or 
subject matter, with the understanding that IBM may use or distribute whatever information you supply in any way it 
believes appropriate without incurring any obligation to you. Your comments will be sent to the author’s department 
for whatever review and action, if any, are deemed appropriate. 


Note: Copies of IBM publications are not stocked at the location to which this form is addressed. Please direct any 
requests for copies of publications, or for assistance in using your IBM system, to your IBM representative or to 
the IBM branch office serving your locality. 


What is your occupation? 


a How did you use this publication? 
( ; : (| As an introduction (1) As a textbook (student) 
= O Asa user’s guide O As a textbook (instructor) 
(11 As a reference manual 1) For another purpose (explain) 


Is there anything you especially like or dislike about the organization, presentation, or writing in this manual? Helpful 
comments include general usefulness of the book; possible additions, deletions, and clarifications; specific errors and 
omissions. 


Page: Comment: 


Number of latest TNL (if any) for this publication: 


If you wish a reply, give your name and address: 


IBM branch office serving you: 


Thank you for your cooperation. Please give this form to your IBM branch office or IBM representative who will be 
happy to forward your comments directly to the address on the other side. 


Reader’s Comment Form 
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